home *** CD-ROM | disk | FTP | other *** search
/ SGI Enlighten DSM 1.1 / SGI EnlightenDSM 1.1.iso / sco5x / events / help / testtab5.man < prev   
Text File  |  1998-06-30  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. TESTTAB(5)         Headers, Tables, and Macros         TESTTAB(5)
  5.  
  6.      Copyright (c) 1990-1998 Enlighten Software Solutions, Inc.
  7.  
  8.  
  9.      testtab - AgentMon subagent capability database
  10.  
  11. SYNOPSIS
  12.      $ENLIGHTEN/config/testtab.{HOSTNAME}
  13.  
  14. DESCRIPTION
  15.      testtab  is  the  capability  database  for   the   AgentMon
  16.      subagent.  The format is similar to other Unix system admin-
  17.      istrative files but is simplier to use.   AgentMon  accesses
  18.      this database when it starts up and frequantly checks it for
  19.      any changes.  Each entry in the file describes one test that
  20.      AgentMon  is capable of performing.  Test may be dynamically
  21.      added  and  deleted  without  having  to  manually   restart
  22.      AgentMon.   At  time  of installation, this file may not yet
  23.      exit.  When no testtab file exist, all default tests and all
  24.      test capability defaults are assumed and the testtab file is
  25.      automatically created.  Each entry in this file represents a
  26.      test description . A test description consist of a line con-
  27.      taining the test name followed by additional lines  contain-
  28.      ing  a  list  of  keywords and, possibly, values.  There are
  29.      three types of keywords (capabliities) :
  30.  
  31.      Boolean
  32.           Capabilities  that  have  only  two   states   (on/off,
  33.           enable/disable,  etc) are specified by simply specifing
  34.           that capability name (to activate it), or by prepending
  35.           the  name with an exclaimation mark ("!") to deactivate
  36.           it.
  37.  
  38.      Numerics and Strings
  39.           A capability that requires a numeric (or alphabetic) is
  40.           specified  by  separating the capability name and value
  41.           with an equal sign.
  42.  
  43.      All capabilities are delimited by  colons  (":")  .   Values
  44.      that  must contain a colon must be escaped with a backslash.
  45.      Any test description line not terminated with a backslash is
  46.      assumed to be the last line of that test description.
  47.  
  48. CAPABILITIES
  49.      Name      Type      Default   Comment
  50.  
  51.      testfreq  int       5         min testing interval (minutes)
  52.      alarmfreq int       60        min   time   between   alarms.
  53.      notify    str       root      to   whom   alarms  are  sent.
  54.      mailer    str       /bin/mail Program  that   will   deliver
  55.                                    the   alarm   if   a  username
  56.                                    was   given    in    'notify'.
  57.      command   str       NULL      The  pathname  of a process to
  58.      start when an
  59.                              alarm       condition        occurs.
  60.      log       boolean   false     Indicates    weather   logging
  61.  
  62.  
  63.  
  64. SunOS 5.4         Last change: 16 April 1993 ;                  1
  65.  
  66.  
  68.  
  69.  
  70. TESTTAB(5)         Headers, Tables, and Macros         TESTTAB(5)
  71.  
  72.  
  73.  
  74.                                    is     enabled     or     not.
  75.      !log      boolean   true      Indicates      logging      is
  76.                                    dissabled.
  77.      delta     int/float 0         If    logging    is   enabled,
  78.                                    the    most    recent    value
  79.                                    measured    will   be   logged
  80.                                    if   it    differs    by    at
  81.                                    least  this  amount  from  the
  82.                                    previously logged value.
  83.                              If      zero,      always       logs
  84.      pep       boolean   false  If true, alarms will also be sent
  85.      to PEP age       int       0         For  monitoring  queues
  86.                                    only.   Age   is  in  minutes.
  87.                                    If  not   zero,   only   files
  88.                                    more    than   'age'   minutes
  89.                                    old are  counted  as  'old'  .
  90.      high      int/float 0         High  level  alarm  set point.
  91.      low       int/float 0         Low  level  alarm  set  point.
  92.      +rate     float     0.0       Positive      rate      change
  93.                                    set         point.           -
  94.      rate     float     0.0       Negitive       rate      change
  95.                                    set                     point.
  96.      +jump     int/float 0         Positive  jump  set  point.  -
  97.      jump     int/float 0         Negitive   jump   set    point.
  98.      testname  str                 Testnames  for  built-in  test
  99.                                    may    not     be     altered.
  100.      regx_     R/E       null      regx1-regx31   are   for  File
  101.      Clamping tests. They hold                                the
  102.      lists   of   regular   expressions   used   in   the   test.
  103.      units     str       "units"   These    are    preset     and
  104.                                    changes      are      silently
  105.                                    ignored.
  106.  
  107.      NOTES
  108.  
  109.      Most test measure  integer  values.  Some  measure  floating
  110.      point values.  Set point parameters should be given by using
  111.      the same variable type as the test result.  However, failure
  112.      to comply will only result in rounding errors.
  113.  
  114.      The jump and rate thresholds compare the current test  value
  115.      with  the last measured value.  Therefore, they are compair-
  116.      ing change over time (testfreq) .
  117.  
  118.      The values for the units capability are built-in and  cannot
  119.      be  changed.   It is shown here for completeness as AgentMon
  120.      includes this field whenever it re-writes the  testtab  file
  121.      and whenever it is started with the -x command line option.
  122.  
  123.      If   the   notify   field   is   set   to   "nobody",   i.e.
  124.      :notify=nobody:, then no email will be sent.
  125.  
  126.  
  127.  
  128.  
  129. SunOS 5.4         Last change: 16 April 1993 ;                  2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TESTTAB(5)         Headers, Tables, and Macros         TESTTAB(5)
  137.  
  138.  
  139.  
  140. SEE ALSO
  141.      printcap(5)  termcap(5)   disktab(5)   acucap(5)
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. SunOS 5.4         Last change: 16 April 1993 ;                  3
  196.  
  197.  
  198.  
  199.